Skip to content

docs(publish): record the first Go SDK release (sdk/go/v0.1.0) - #72

Merged
macanderson merged 1 commit into
mainfrom
docs/go-sdk-published
Aug 1, 2026
Merged

docs(publish): record the first Go SDK release (sdk/go/v0.1.0)#72
macanderson merged 1 commit into
mainfrom
docs/go-sdk-published

Conversation

@macanderson

@macanderson macanderson commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Records the Go SDK publish that just happened — the sdk/go/v0.1.0 tag is pushed on green main (4377bff3), which for a Go module is the publish.

Verified before this PR:

  • proxy.golang.org serves github.com/macanderson/context-graph-protocol/sdk/go v0.1.0 — the first go get was run deliberately to seed the proxy + checksum DB, per sdk/PUBLISHING.md's own recommendation, and a scratch module records the go.sum entry.
  • The example provider built against the externally-fetched module (not the checkout) passes all 13 checks in conformance-external.sh — the P0: Publish the provider SDKs to PyPI and the Go module registry #59 acceptance bar, now met for all three SDKs.
  • verify-go (the only job an sdk/go/v* tag can trigger — the publish-* jobs are dispatch-only) is green.

Doc flips: CHANGELOG entry, sdk/PUBLISHING.md status table (all three SDKs ✅), sdk/go/README install snippet pinned to @v0.1.0 with the 'not yet published' caveat removed.

Summary by Sourcery

Document the first Go SDK publish and update SDK publishing status across docs.

Documentation:

  • Add CHANGELOG entry describing the first Go SDK release and its verification steps.
  • Update sdk/PUBLISHING.md to mark the Go SDK as published and adjust the checklist wording for subsequent releases.
  • Revise sdk/go/README install instructions to reference the published v0.1.0 module instead of a not-yet-published caveat.

The tag is pushed on green main (4377bff) and the module is live:
proxy.golang.org serves sdk/go v0.1.0 with a recorded sum.golang.org
checksum, and the example provider built against the externally-fetched
module passes all 13 conformance checks. verify-go (the only job an
sdk/go/v* tag triggers) is green.

- CHANGELOG: add the Go publish entry; all three SDKs and all three
  crates are now live.
- sdk/PUBLISHING.md: flip the Go row to published; the file is now the
  checklist for subsequent releases.
- sdk/go/README: drop the 'not yet published' caveat; pin the install
  snippet to @v0.1.0.
@sourcery-ai

sourcery-ai Bot commented Aug 1, 2026

Copy link
Copy Markdown
Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

Records and documents the first Go SDK publish (sdk/go/v0.1.0), updating changelog, publishing status table, and Go SDK README install instructions to reflect that the module is now published and pinned to v0.1.0.

Flow diagram for Go SDK v0.1.0 publish and verification

flowchart TD
  A[tag sdk/go/v0.1.0 on green main 4377bff3] --> B[go get github.com/macanderson/context-graph-protocol/sdk/go/contextgraph@v0.1.0]
  B --> C[proxy.golang.org/sum.golang.org seeded]
  C --> D[example provider build against external module]
  D --> E[.github/scripts/conformance-external.sh passes 13 checks]
  A --> F[verify-go GitHub job runs]
  F --> G[verify-go green]
  E --> H[All three SDKs and crates recorded as published in docs]
  G --> H
Loading

File-Level Changes

Change Details Files
Document the first Go SDK publish in the main changelog, including verification steps and final state of all SDKs/crates.
  • Replace note that Go module publish remains outstanding with a new bullet describing the sdk/go/v0.1.0 tag-based publish.
  • Describe the deliberate seeding of Go module proxy and checksum DB via go get and scratch module.
  • Note that the example provider built against the externally-fetched module passes all conformance checks and that the verify-go job is green.
  • State that all three SDKs and all three crates are now published.
CHANGELOG.md
Update the SDK publishing checklist/status table to mark the Go SDK as published and clarify the ongoing role of the document.
  • Mark Go SDK row as published 0.1.0 with date and tag information in the status table.
  • Replace text indicating Go publish has not yet happened with text noting all first publishes are complete.
  • Clarify that the document now serves as the checklist for subsequent releases, mirroring the crates publishing doc.
sdk/PUBLISHING.md
Adjust the Go SDK README to show the actual published install command, pinned to v0.1.0, and remove the pre-publish caveat.
  • Remove the pre-publish warning explaining the tag has not been cut and suggesting pseudo-versions or vendoring.
  • Update the go get command to include an explicit @v0.1.0 version suffix matching the published tag.
sdk/go/README.md

Possibly linked issues

  • #P0: The issue asks to publish SDKs; this PR documents and verifies the Go SDK’s first publish, completing that part.

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've found 1 issue

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="sdk/PUBLISHING.md" line_range="18-19" />
<code_context>
-**Nobody has run the Go publish steps yet.** This file exists so the
-*first* real publish of each is a checklist, not an improvisation — exactly
-the role [`../PUBLISHING.md`](../PUBLISHING.md) plays for the crates.
+**All three first publishes have now happened.** This file remains the
+checklist for every *subsequent* release, so a version bump is a checklist,
+not an improvisation — exactly the role
</code_context>
<issue_to_address>
**suggestion (typo):** Wording of “first publishes” is awkward; consider a more natural phrase.

“First publishes” is an unusual noun phrase. Please reword this sentence for clarity, e.g., “All three initial publishes have now happened,” “All three first publications have now happened,” or “All three first releases have now happened.”

```suggestion
**All three initial publishes have now happened.** This file remains the
checklist for every *subsequent* release, so a version bump is a checklist,
```
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Comment thread sdk/PUBLISHING.md
Comment on lines +18 to +19
**All three first publishes have now happened.** This file remains the
checklist for every *subsequent* release, so a version bump is a checklist,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion (typo): Wording of “first publishes” is awkward; consider a more natural phrase.

“First publishes” is an unusual noun phrase. Please reword this sentence for clarity, e.g., “All three initial publishes have now happened,” “All three first publications have now happened,” or “All three first releases have now happened.”

Suggested change
**All three first publishes have now happened.** This file remains the
checklist for every *subsequent* release, so a version bump is a checklist,
**All three initial publishes have now happened.** This file remains the
checklist for every *subsequent* release, so a version bump is a checklist,

@macanderson
macanderson merged commit f602a1b into main Aug 1, 2026
19 checks passed
@macanderson
macanderson deleted the docs/go-sdk-published branch August 1, 2026 07:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant